home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / dvpeg30l.zip / DVPEG.DOC < prev    next >
Text File  |  1994-02-12  |  14KB  |  387 lines
  1.           Dvpeg 3.0l - dvpeg.doc file
  2.           ---------------------------------
  3.  
  4. Use:  Dvpeg is a DOS based (286 or up) JPEG / GIF / Targa / PPM viewer
  5.     (limited BMP support)
  6.     that will run under DOS, Windows, OS\2.
  7.  
  8.  
  9.   Limitations
  10.   -----------
  11.   Viewing of JPEG, some Targa and all PPM images require a 15/16/24 bit
  12.   video card for speed and image quality.  JPEG images can be viewed on
  13.   256 color modes but will take longer to decode.  Targa and PPM images
  14.   can be viewed on 256 color modes but they will be in grayscale.  If the
  15.   original image was color the red portion is used to set the brightness.
  16.  
  17.   16 color modes are supported as color or gray.  Nothing less (ie
  18.   monochrome) is supported.
  19.  
  20.  
  21.   Speed
  22.   -----
  23.   For maximum speed set the shrinking to 1:1
  24.   You can always shrink the picture after, if the panning is on.
  25.   For faster JPEGs on 16 color modes turn off the quantizing (default).
  26.   For speed on 256 or 16 color card use 1 pass quantize, no dithering
  27.      or grayscale viewing.
  28.   For faster scans of directories turn off the "4DOS info" and "file info".
  29.  
  30.  
  31.   JPEG Image Quality
  32.   ------------------
  33.   Best quality for 16 & 256 color video mode JPEGs is 2 pass quantizing.
  34.   The JPEG medium/high quality switch will usually show no difference.
  35.   But the high quality setting is slightly more accurate and slower.
  36.  
  37.  
  38. To run dvpeg use:
  39.  dvpeg <file_path>\<file_mask>
  40.   ie dvpeg ..\gifs\new\*.jpg
  41.     or
  42.  dvpeg <options> <@file> <picture_file(s)>
  43.   ie dvpeg +mask *.jpg  [this is the same as dvpeg *.jpg]
  44.   ie dvpeg +initshow *.jpg <+addslide joey.tga> +slideshow
  45.          this setups up theslide show, adds all *.jpg files the joey.tga and
  46.          then runs the slideshow
  47.  
  48.  
  49. where anything in "<>" is optional
  50.  
  51. For example using:  dvpeg +title "*This is it" stars.gif +exit
  52.   will show the picture file stars.gif with the title 'This is it',
  53.   pause for a keypress and then exit.
  54.  
  55. The @file is called a response file. DOS is limited to lines of 256
  56. characters.  If you wish to have very long files of options then you can
  57. put all of the options into a text file and simply give the viewer the
  58. name of the file.  One option per line of the response file.
  59.  
  60.  
  61. Options on the command line or response file
  62. --------------------------------------------
  63. Each option must start with one of the following characters:
  64.  
  65. ; -> start of a comment line in the response file (line is ignored)
  66. + -> turns an option on
  67. - -> turns an option off
  68. * -> the rest of this arguement is a text string (only used for the
  69.          title to be displayed or the text line; nothing else
  70. Anything else is assumed to be the a filename for viewing
  71.  
  72. For each option you must use at least the first 3 characters.
  73. For each of the lines a # symbol means that a number is expected.
  74.  
  75. NOTE:  There is a difference between response files and command line
  76. options.  For example on the command line you need double quotes around
  77. character strings while they are not required for response files.
  78.   ie on the command line: +name "*copyright message here"
  79.       or the response file: +name *copyright message here
  80.  
  81. All options require a + or - prefix.
  82.  
  83.  
  84. External Control Options (not available in the viewer)
  85. ------------------------------------------------------
  86. config    -> the name of the configuration file must follow this
  87.  
  88. clscreen    -> setup, clear the text screen and print title
  89.  
  90. notext    -> do not return to text screen when exiting DVPEG
  91.     -> this will leave the picture on the screen in graphics mode
  92.  
  93. name    -> with this you can set the name printed in the lower left corner
  94.     -> if a text string follows it will be used as the string to print
  95.     -> otherwise the file name is used
  96.     -> ie -name or +name or +name *This is the file name
  97.  
  98. title    -> this allows you to print a title to the top, center of the screen
  99.     -> if a text string follows it will be used, if there is no string
  100.     -> then the 4DOS file description is the default
  101.  
  102. controls  -> turn pause after decoding picture on/off (on = no pause)
  103.     -> this is reset to pausing after a slideshow
  104.     -> pausing means waiting for a keypress
  105.  
  106. usefiles    -> don't clear the list of files added to the slideshow list
  107.     -> this means the slideshow files will be the only ones on the
  108.     -> file list when it pops up
  109.  
  110. exit    -> this will result in an immediate exit from the viewer, it will
  111.     -> not set the text screen unless the notext option is off!
  112.  
  113.  
  114. Control Options (changable within the viewer)
  115. ---------------------------------------------
  116. nolist -> turn off the file selection list,  The user then has 3 options;
  117.      ESC to exit, RTN and N for next picture, P for previous picture.
  118.      No other options exist.
  119.  
  120. delay #  -> the delay between pictures in the slideshow
  121.  
  122. keypress -> wait for an immediate keypress
  123.  
  124. lock #  -> This will lock/unlock the viewer into using one video resolution
  125.     -> for example +lock 480 will lock it into the 640 * 480 mode for
  126.     -> all pictures, -lock will turn it off -> no number is expected
  127.  
  128. menu  -> this will turn the menu on ie where you can select the video
  129.     -> resolution and change some options like panning
  130.  
  131. beep  -> turn the end of picture beep on or off
  132.  
  133. mask  -> if + add a file mask to the list (maximum 5 currently)
  134.     -> if - then clear the list of file masks
  135.  
  136. tree -> turn file tree on/off
  137.  
  138. drives -> turn list of drives on/off
  139.  
  140. long -> toggle file list between short/long
  141.  
  142. fifty -> turn 50 line text mode on/off
  143.  
  144. clgr -> turn clear_graphics_screen_before_draw on/off
  145.  
  146. path -> set the file drive, path used by the viewer ie d:\pics\new
  147.     -> do not use a \ at the end
  148.     -> other examples:  \\gifs\new  ie hop back to the root but keep drive
  149.     ->  or ..\test\pics ie hop back one branch and add to it
  150.     ->  or pics\new  ie add to the current dir. path (don't need .\)
  151.  
  152.  
  153. Slideshow Options
  154. -----------------
  155. initshow -> initialize the slideshow and clear the list of files
  156.     -> this must be called before any slideshow files are put into
  157.     -> the list
  158.  
  159. addslide -> add a file name to the slideshow
  160.  
  161. slideshow -> start the slideshow of the given file names
  162.      -> it will exit if the user hits ESC or there is a file error
  163.      -> on a severe error the viewer may terminate
  164.      -> the continous slideshow flag is cleared upon exiting the show
  165.  
  166. continous -> if used before slideshow the show will run continously
  167.  
  168.  
  169. Viewing Options
  170. ---------------
  171. -shrink   -> turn automagic shrinking on/off (shrink to fit video mode by
  172. +shrink #    -> using 1/1, 1/2, 1/3, .. 1/6
  173.     -> if the shrinking is being turned on the it must be followed with
  174.     -> a number, 0 = automatic, anything else will lock the shrink ratio
  175.  
  176. panning    -> turn the panning ability on/off
  177.     -> this can use a lot of memory and take time
  178.     -> do not use this when doing a slideshow since the user can not
  179.     -> (currently) do any panning or adjust any controls
  180.  
  181.  
  182. JPEG Options
  183. ------------
  184. grayscale -> turn grayscale viewing for JPEGs on/off
  185.  
  186. quantize    -> turn 2 pass quantizer on/off
  187.  
  188. dithering    -> turn JPEG dithering on/off
  189.  
  190.  
  191.  
  192. Memory requirements
  193. -------------------
  194.   GIF viewing typically requires 190,000 bytes.
  195.   JPEGs take 174,000 + X size * 144  (X size is the width of the picture)
  196.  
  197.   If the image is going to be panned then even more memory (EMS, XMS, ..)
  198.   is required.  In the case of 640 * 480 picture in a 15/16 bit mode
  199.   (ie hi-color) then another 1M of memory is required.  If this can not
  200.   be found the program will use temporary files on the harddrive (slow).
  201.   Extra memory for panning is simply:  X size * Y size * bytes per pixel.
  202.      Where 16, 256 color is 1 byte/pixel
  203.          15/16 bit are 2 bytes/pixel
  204.          24 bit is 3 bytes/pixel
  205.  
  206. Memory Problems
  207. ---------------
  208.   If you are running out of far memory then you should reduce the size of
  209.   the file list (under F7).  The default is 500, maximum is 2,000 and it
  210.   takes about 50 bytes/item.
  211.  
  212.   Slideshow memory problems can be caused by using the decode to buffer.
  213.   This can require a lot of memory and should not be used unless you have
  214.   plenty.
  215.  
  216.  
  217. Memory Problems with JPEGs
  218. --------------------------
  219.   If you are running out of memory then most likely it